home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.3 (Developer)…68k, x86, SPARC, PA-RISC] / NeXTSTEP 3.3 Dev Intel.iso / usr / sybase / doc / dbtsnewval.man < prev    next >
Text File  |  1993-04-22  |  2KB  |  67 lines
  1.  
  2.   1                       Version 4.0 -- 5/1/89               dbtsnewval
  3.   ______________________________________________________________________
  4.  
  5.   NAME:  dbtsnewval
  6.  
  7.   FUNCTION:
  8.        Return the new value of the timestamp column after a  browse-mode
  9.        update.
  10.  
  11.   SYNTAX:
  12.        DBBINARY *dbtsnewval(dbproc)
  13.  
  14.        DBPROCESS *dbproc;
  15.  
  16.   COMMENTS:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.   dbtsnewval              Version 4.0 -- 5/1/89                        2
  25.   ______________________________________________________________________
  26.  
  27.        o dbtsnewval() is one of the  DB-Library  browse  mode  routines.
  28.          See the Introduction for a detailed discussion of browse mode.
  29.        o dbtsnewval() provides information about the  timestamp  column.
  30.          The  WHERE  clause  returned by dbqual() contains a call to the
  31.          tsequal built-in function.  When such a WHERE clause is used in
  32.          an UPDATE statement, the tsequal function places a new value in
  33.          the updated row's timestamp column and returns the  new  times-
  34.          tamp  value  to  the application (if the update is successful).
  35.          This routine allows the application to save the  new  timestamp
  36.          value, possibly for use with dbtsput().
  37.  
  38.   PARAMETERS:
  39.        dbproc -  A pointer to the DBPROCESS structure that provides  the
  40.            connection for a particular front-end/SQL Server process.  It
  41.            contains all the information that DB-Library uses  to  manage
  42.            communications and data between the front end and SQL Server.
  43.  
  44.  
  45.  
  46.   3                       Version 4.0 -- 5/1/89               dbtsnewval
  47.   ______________________________________________________________________
  48.  
  49.   RETURNS:
  50.        A pointer to the updated row's new timestamp value. If no  times-
  51.        tamp was returned to the application (possibly because the update
  52.        was unsuccessful, or because the UPDATE statement did not contain
  53.        the tsequal built-in function), the pointer will be NULL.
  54.  
  55.   SEE ALSO:
  56.        dbcolbrowse, dbcolsource, dbqual, dbtabbrowse, dbtabcount, dbtab-
  57.        name, dbtabsource, dbtsnewlen, dbtsput
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.